home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / uncompvm.z / uncompvm
Encoding:
Text File  |  2001-04-17  |  5.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. uuuunnnnccccoooommmmppppvvvvmmmm((((1111MMMM))))                                                      uuuunnnnccccoooommmmppppvvvvmmmm((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      uncompvm - expand a compressed IRIX vmcore dump of the operating system
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////eeeettttcccc////uuuunnnnccccoooommmmppppvvvvmmmm [ ----hhhhHHHHvvvvffffdddd ] [ ----ssss _m_a_x__m_b_y_t_e_s ]
  13.      [ ----bbbb  _b_l_o_c_k__n_u_m_b_e_r | _l_i_s_t | _c_h_e_c_k ] _c_o_r_e_n_a_m_e [ _o_u_t_f_i_l_e ]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _u_n_c_o_m_p_v_m expands IRIX vmcore.n.comp files into standard vmcore.n files.
  17.  
  18.      Under some circumstances, an IRIX operating system core dump may be made
  19.      in a special compressed format.  Running _f_i_l_e(1) on a vmcore.n.comp file
  20.      yields something like the following:
  21.  
  22.           vmcore.0.comp:  IRIX vmcore dump of  'IRIX abu stever-j 03080214 IP19'
  23.  
  24.      _u_n_c_o_m_p_v_m without any command-line options uncompresses these into files
  25.      of up to the size of the physical memory on the system that created the
  26.      dump.  For this reason, it may not be advisable to expand such dumps.  If
  27.      _o_u_t_f_i_l_e is not specified, _u_n_c_o_m_p_v_m expands the dump into vmcore.n without
  28.      the .comp extension.
  29.  
  30.      The options are:
  31.  
  32.      ----hhhh              Header mode.  In header mode, _u_n_c_o_m_p_v_m does not
  33.                      uncompress the entire dump file, but rather decodes the
  34.                      dump header which contains information about the system
  35.                      and the reason it created a vmcore file.
  36.  
  37.      ----HHHH              Long header mode.  Like header mode, but it prints a more
  38.                      complete accounting of the information in the dump
  39.                      header.
  40.  
  41.      ----dddd              Debug mode. Useful only for debugging _u_n_c_o_m_p_v_m.
  42.  
  43.      ----vvvv              Verbose mode. Prints additional information for each
  44.                      block of the _c_o_r_e_n_a_m_e.
  45.  
  46.      ----ssss _m_a_x__m_b_y_t_e_s   Specifies the maximum size of the expanded vmcore.n file
  47.                      in megabytes.
  48.  
  49.      ----bbbb _b_l_o_c_k__n_u_m_b_e_r Print detailed information about a particular
  50.                      _b_l_o_c_k__n_u_m_b_e_r. The _b_l_o_c_k__n_u_m_b_e_r of interest can be
  51.                      possibly obtained by first running the 'uncompvm -b list
  52.                      corename'. (Output goes to stdout).
  53.  
  54.      ----bbbb _l_i_s_t         Print specific header information for each block of the
  55.                      _c_o_r_e_n_a_m_e. (Output goes to stdout, generates lots of
  56.                      output!).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. uuuunnnnccccoooommmmppppvvvvmmmm((((1111MMMM))))                                                      uuuunnnnccccoooommmmppppvvvvmmmm((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      ----bbbb _c_h_e_c_k        _u_n_c_o_m_p_v_m will read all _c_o_r_e_n_a_m_e and verify the
  75.                      completeness and correctness of the _c_o_r_e_n_a_m_e dump. No
  76.                      output will be generated unless errors were detected.
  77.  
  78.      When -b is specified, _u_n_c_o_m_p_v_m will not generate the uncompressed _o_u_t_f_i_l_e
  79.      even if the _o_u_t_f_i_l_e has been specified on the _u_n_c_o_m_p_v_m call. The -b
  80.      option is useful to see more in details the internals of the _c_o_r_e_n_a_m_e and
  81.      it is thus most used by developers.
  82.  
  83. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  84.                     _uuuu_nnnn_cccc_oooo_mmmm_pppp_vvvv_mmmm _----_ssss _1111_6666 _vvvv_mmmm_cccc_oooo_rrrr_eeee_...._0000_...._cccc_oooo_mmmm_pppp
  85.  
  86.  
  87.      This uncompresses vmcore.0.comp into vmcore.0, truncating the size of
  88.      vmcore.0 to 16 megabytes if necessary.
  89.  
  90.                     _uuuu_nnnn_cccc_oooo_mmmm_pppp_vvvv_mmmm _----_bbbb _cccc_hhhh_eeee_cccc_kkkk _vvvv_mmmm_cccc_oooo_rrrr_eeee_...._0000_...._cccc_oooo_mmmm_pppp
  91.  
  92.  
  93.      This will read through the coredump and verify its correctness and
  94.      completeness. No output will be generated unless errors were detected.
  95.  
  96. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  97.      _uuuu_nnnn_cccc_oooo_mmmm_pppp_vvvv_mmmm_:::: _ffff_iiii_llll_eeee_nnnn_aaaa_mmmm_eeee _iiii_ssss _nnnn_oooo_tttt _aaaa_nnnn _IIII_RRRR_IIII_XXXX _cccc_oooo_mmmm_pppp_rrrr_eeee_ssss_ssss_eeee_dddd _dddd_uuuu_mmmm_pppp _ffff_iiii_llll_eeee_!!!! is printed if
  98.      _u_n_c_o_m_p_v_m doesn't recognize the file as a compressed dump file.
  99.  
  100. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  101.      savecore(1M), trcore(1M).
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.